﻿<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
	<link rel="Stylesheet" type="text/css" media="screen" href="Screen.css" />
  <title>STP_SetPortPriority</title>
</head>
<body>
	<h3>STP_SetPortPriority</h3>
	<hr />
<pre>
void STP_SetPortPriority
(
    BRIDGE*        bridge,
    int            portIndex,
    int            treeIndex,
    unsigned char  portPriority,
    unsigned long  timestampMilliseconds
);
</pre>
	<h4>
		Summary</h4>
	<p>
		Sets the priority component - most significant 4 bits - of the portId. See §13.25.32 in 
		802.1Q for more details.</p>
	<h4>
		Parameters</h4>
	<dl>
		<dt>bridge</dt>
		<dd>Pointer to a BRIDGE object, obtained from <a href="STP_CreateBridge.html">
			STP_CreateBridge</a>.</dd>
		<dt>portIndex</dt>
		<dd>The zero-based index of the port.</dd>
		<dt>treeIndex</dt>
		<dd>The zero-based index of the spanning tree for which the port priority is to be set. For 
			RSTP mode, this must always be zero. For MSTP, it must also be zero, since the current 
			library code only supports one spanning tree - the CIST.</dd>
		<dt>portPriority</dt>
		<dd>A value between 0 and 240, in steps of 16.</dd>
	</dl>
	<h4>
		Remarks</h4>
		<p>
			Execution of this function is a potentially lengthy process. 
			It may call various callbacks multiple times.</p>

</body>
</html>
